home *** CD-ROM | disk | FTP | other *** search
/ HTBasic 9.3 / HTBasic 9.3.iso / SICL / data1.cab / rvxi32 / devices next >
Encoding:
Text File  |  2001-03-02  |  7.4 KB  |  199 lines
  1. # RadiSys EPConnect device definition file.
  2. #
  3. # $Revision:   1.8  $
  4. # $Date:   20 Jan 1995 14:45:16  $
  5. #
  6. # Configuration data begins at line containing ">>> Configuration starts here"
  7. #
  8. # This file defines the names for the devices reachable with EPConnect
  9. # software for use by the RadiSys SURM and certain other utilities,
  10. # possibly including the VXI configurator.  This is a human editable file,
  11. # but beware that some utilities that edit this file may not preserve the
  12. # whitespace within device definitions they change.
  13. #
  14. # Device definitions have the following form:
  15. #
  16. # <definition>          : <name-assignment> [,<variable-assignment>]* <newline>
  17. # <name-assignment>     : "name" "=" <devicename>
  18. # <variable-assignment> : <variable>=<value>
  19. # <variable>            : <string>
  20. # <value>               : <string>
  21. #
  22. # A string is a sequence containing any characters except an unquoted
  23. # comma or equal sign.  Unquoted leading or trailing whitespace characters 
  24. # will be removed from strings.
  25. #
  26. # A devicename is an IEEE 488.2 device name.
  27. #
  28. # The variables allowed depend on the device type.  In general, incorrectly
  29. # named variables are ignored.  The form of the value assigned depends on
  30. # the variable.  See below for expected variables and allowed values.  In 
  31. # general variable name matching is case insensitive.  If the value is an
  32. # ordinal type (i.e. {"VME","VXI","GPIB"}) value matching is also case
  33. # insensitive.
  34. #
  35. # The primary application of this file if for device configuration via
  36. # the Start Up Resource Manager (SURM).  The variables used by the SURM
  37. # are:
  38. #
  39. # name
  40. # 
  41. # All devices must have a name variable defined.  The name must conform to
  42. # the IEEE 488.2 spec for device names. 
  43. # 
  44. # media
  45. # 
  46. # All devices must have a media variable defined.  Valid values are VXI,
  47. # VME, and GPIB.  The value of this variable affects the interpretation
  48. # of some of the other variables, and determines how the device will be
  49. # treated by the SURM. 
  50. # 
  51. # make 
  52. # model
  53. # 
  54. # All devices may have make and model variables assigned.  They are used
  55. # for name binding in the SURM and future reference by user applications. 
  56. # To be effective for naming VXI devices, they must match exactly one of
  57. # the make or model names defined in vximanuf or vximodel, respectively. 
  58. # 
  59. # slot 
  60. # bus
  61. # 
  62. # A VXI device may have a slot and/or bus variable defined for name binding 
  63. # purposes.  These are both in decimal.  See the SURM documentation for
  64. # details on VXI and MXI bus numbering.
  65. # 
  66. # device
  67. # 
  68. # A VXI device may have a device variable defined for name binding. 
  69. # Though rare (possibly nonexistent), it is possible for multiple devices
  70. # to exist within a single VXI plug-in module.  This variable provides a
  71. # mechanism to distinguish them for naming.  This value is in decimal. 
  72. # The first device in a module is number 0. 
  73. # 
  74. # ula 
  75. # 
  76. # A VXI device may have a ula variable defined for name binding.  The ULA
  77. # is in decimal.  This is not the recommended way to name dynamically
  78. # configured devices, since their ULAs are not entirely predictable.  For
  79. # historical reasons, all devices are given ULAs regardless of whether
  80. # they have configuration registers in A16 (or contact the VXI bus at
  81. # all).  For non-VXI devices, the ULA is assigned based on this variable
  82. # if defined.  Otherwise a convenient value is selected by the SURM. 
  83. # 
  84. # commander 
  85. # 
  86. # Any device may have a comander variable defined.  The value of this 
  87. # variable is the name of anotehr device.  If the device and its commander 
  88. # are both VXI, appropriate action is taken by the SURM to make the deice 
  89. # a VXI servant of the named commander.  For other media types, the 
  90. # relationship is stored for reference. 
  91. # 
  92. # handlermap 
  93. # interruptermap
  94. # 
  95. # Any VXI or VME device may have interrupt maps defined by these
  96. # variables.  The handlermap variable indicates which IRQ lines a device
  97. # can/will handle interrupts on.  If the device is VXI, and has
  98. # programmable handler capability, it will be programmed to handle the
  99. # interrupts specified here.  The interruptermap is treated
  100. # correspondingly.  In any case, IRQ lines specified this way will not be
  101. # assigned by the SURM to any other PH capable VXI device.  Maps for VXI
  102. # devices which are not found in the system are ignored (no IRQs
  103. # reserved).  VME devices are always assumed to be present. 
  104. # The value of these variables is a string of 7 digits.  The rightmost
  105. # digit corresponds to interrupter or handler number 1.  The digits are 1
  106. # through 7, and indicate the IRQ line to which the interrupter or handler
  107. # is connected. 
  108. # 
  109. # a16base
  110. # a16size
  111. # a24base
  112. # a24size
  113. # a32base
  114. # a32size
  115. # 
  116. # VME devices use these variables to define what section of the various
  117. # address spaces they occupy.  Values are in hex.  If either size or base
  118. # is missing, the space is assumed to be unused by the device. 
  119. # 
  120. # byteorder
  121. # 
  122. # VME devices use this to specify what byte order should be used
  123. # when accessing their memory.  Use I for little-endian (Intel), or M for
  124. # big-endian (Motorola). 
  125. # 
  126. # datawidth
  127. # 
  128. # VME devices use this to specify the data width that should be 
  129. # used when accessing their memory.  Use D08 (8-bit), D08O (8-bit odd 
  130. # address only), D16 (16-bit), or D32 (32-bit). 
  131. # 
  132. # primary
  133. # secondary
  134. # 
  135. # GPIB devices must have a primary variable defined.  Secondary defaults
  136. # to 0.  These form the device's address on the GPIB bus. 
  137. # 
  138. #
  139. # Lines beginning with # are comments, and are ignored.
  140. #
  141. # A single character may be quoted by placing a backslash (\) in front of it.
  142. # An entire string may be quoted by surrounding it with double quote 
  143. # characters (").
  144. #
  145. # A quoted newline does not mark the end of a definition, so placing a 
  146. # backslash at the end of a line of a definition causes the next line to
  147. # be treated as a continuation of the definition.
  148. #
  149. # Redundant names provide an OR function of sorts for naming constraints.
  150. # Variables associated with naming VXI devices within a single definition
  151. # are implicitly ANDed.  Be aware that the first assignment of a given 
  152. # variable (the one from the earliest definition) will be the one the SURM
  153. # finds.  For example, no matter which of these TopCmdr definitions causes
  154. # the name to be assigned, the SURM will consider the configured handler map
  155. # to be "1", not "10".
  156. #
  157. # name=TopCmdr,    \
  158. #        media=        VXI,        \
  159. #        make=        "RadiSys Corp",    \
  160. #        model=        EPC-7 S0,    \
  161. #        handlermap=    1,        \
  162. #
  163. # 
  164. # Here's a sample VXI device definition.  This much specification is 
  165. # sufficient if only one of this type of VXI device will be present
  166. # in the system.
  167. #
  168. # name=tekdmm,    \
  169. #        media=        VXI,        \
  170. #        make=        Tektronix,    \
  171. #        model=        VX4236
  172. #
  173. #
  174. # Here's a sample GPIB device definition.
  175. #
  176. # name=tekps,    \
  177. #        media=GPIB, make=Tektronix, model=PS5004,        \
  178. #        primary=1
  179. #
  180. # Here's a minimal VME device definition for a device occupying 64k in A24.
  181. #
  182. # name=ram_card,\
  183. #        media=VME, a24base=800000, a24size=10000
  184. #
  185. #
  186. # ----------------------------------------------------------------------------
  187. # ----------------------------------------------------------------------------
  188. # >>> Configuration starts here
  189.  
  190. # This name will match any RadiSys computer with ULA==0.  The resource
  191. # manager always has ULA==0.
  192. #
  193. # SICL normally requires that the resource manager handle all interrupts.
  194. #
  195. name=TopCmdr,    \
  196.         media=        VXI,        \
  197.         ula=        0,        \
  198.         handlermap=    7654321        
  199.